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INTRODUCTION 


This manual is intended for people who want to learn to pro- 
gram in BASIC on the Color Computer. With a little time and 
effort you will very soon discover then there is nothing very 
difficult about learning how to program your computer. You 
will be introduced to the fundamentals of BASIC and to the 
procedures of programming. Nothing is taken for granted. No 
prior knowledge is presumed. Things are explained. one at a 
time and step by step. All you have to do is to start at the 
beginning and make sure you try everything as it comes up. 
Take your time. Understand one step before going to the next. 

The key to success is to try everything. It is not enough to 
read about it. You must do it. You don’t learn to play the 
piano, type or swim by reading a book. You learn by doing. 
Don’t worry about making mistakes. It is part of the learning 
process. If you do make a mistake, just correct the mistake and 
continue. The computer doesn’t worry about it, why should 
you? There is nothing that can be done from the keyboard that 
can damage your computer. Cautions are included in the text 
when statements that might DESTROY data files are intro- 
duced. Thus, feel free to try things out with your computer at 
every stage of learning. | 

In general, you should follow the SEQUENCE of presenta- 
tion given in the text. However, Chapter 15 which discusses the 
use of tape storage may be read at anytime when you wish to 
save a program on the cassette tape. While this manual is written 
for one who wishes to learn to program in BASIC on this 
Computer, it can also serve as a general introduction to pro- 
gramming in BASIC on any system. Just remember that the 
BASIC language has many forms. There are slight differences 
between one implementation of BASIC and another. 

Finally, this manual will not only help you to understand 
BASIC but it will also help you to understand the fundamentals 
of computer programming in general. 

Have fun with your color computer. 


1. 


Contents 


TABLE OF CONTENTS 


THE COMPUTER Page 9 
— WHAT IS A COMPUTER? | 

— WHAT MAKES UP A COMPUTER SYSTEM? 

— WHAT IS APROGRAM 

— COMPUTER LANGUAGE 

— BASIC 


HOW TO USE YOUR COLOR COMPUTER Page 15 
— TOSTART 

— HOWTO OPERATE THE KEYBOARD 

— PRINT AND[RETURN| 

— SYNTAXERROR © 

— EDITING 

— INSERT 

— CLS 

— A LOOK AHEAD 


YOUR COLOR Cer tee o> A SIMPLE CALCULA- 
TOR Page 29 
— SIMPLE INSTRUCTIONS 

— ORDER OF NUMERIC OPERATIONS 

— BRACKETS 


CONSTANTS AND VARIABLES Page 33 
— CONSTANTS : 
— VARIABLES 

— LET 

SEMI-COLONS AND COMMAS 

COLONS 


PROGRAMMING Page 39 
— INPUT 

— REM 

— NEW 

— RUN 

— LIST 

— PAUSE IN LISTING 

— DELETINGA LINE 


6. NUMERIC FUNCTIONS 


— WHAT IS A FUNCTION 


ABS 
SGN 
SOR 
LOG 
EXP 
INT 
RND 
SIN 
COS 
TAN 
ATN 


7. STRINGS 
— STRING VARIABLES 
— STRING FUNCTIONS 
LEN 
STR$ 
VAL 
LEFT$ 
RIGHT$ 
MID$ 
ASC 
CHR$ 


-_ STRING COMPARISONS 


— INKEY$ 


— GOTO 
— BREAK 
— CONT 
— STOP 
— END 


— CLEAR 


9. CONDITIONS 
— IF...THEN...ELSE 


— CONDITIONAL BRANCHING 
LOGICAL OPERATORS 


— TRUTH TABLES 


COMPUTER PROGRAMMING REVISITED 


6 


Contents 


Page 47 


Page 53 


Page 63 


Page 69 





10. 


11. 


12. 


13. 


LOOPING 
— FOR...TO 
— NEXT 
— STEP 


SUBROUTINE 
— GOSUB 
— RETURN 


LISTS AND TABLES 
— ARRAYS 
— DIM 


READ, DATA, RESTORE 
— READ 


.- DATA 


14. 


15. 


16. 


— RESTORE 


PEEK AND POKE 
— PEEK 
— POKE 


STORING PROGRAM ON TAPE 
(CASSETTE INTERFACE) 

— SETTING IT UP 

— CLOAD 

— VERIFY 

— CSAVE 

— CRUN 

— PRINT # 

— INPUT # 


GRAPHICS 

— MODES | | 
— GRAPHIC CHARACTERS 
— INVERSE 

— SET 

— RESET 

— POINT 


Contents 


Page 77 


| Page 83 


Page 87 


Page 93 


Page 99 


Page 107 


Page 115 


17. MORE COMMANDS AND INFORMATION 
— PRINT@ 
— PRINT TAB - 
— PRINT USING 
— INP 
— OUT 
— USR 


18. SOUND AND SONGS 
— SOUND 
— SONGS 


19. COLOR 
— COLOR 


20. THE PRINTER 
— LLIST 
— LPRINT 
— COPY 


APPENDIX 
~ - — ERROR MESSAGE 
— ASCII CODE TABLE 
— SUMMARY OF BASIC COMMANDS 


Contents 


Page 121 


Page 129 


Page 135 


Page 139 


Page 143 





CHAPTER 


THE COMPUTER 


— WHAT IS A COMPUTER? 
— WHAT MAKES UP A COMPUTER SYSTEM? 
— WHAT IS A PROGRAM? 


— COMPUTER LANGUAGE 
— BASIC 


10 











Chapter 1 


WHAT IS A COMPUTER? 


A computer is a device which performs various operations based 
on instructions given by the one who uses it. The computer 
cannot tell the user how to solve a problem. It has to be told 
what to do. The computer cannot think. Yet it is a very effec- 
tive tool in the hands of a competent and experienced user. 

A computer system consists of a number of machines or 
devices where operations are coordinated by a central control 
unit. These machines when working together are able to per- 
form simple logical and arithmetic processes such as comparing 
two numbers. They can also read in information, store this 
information and give out results in a form understandable by us. 


WHAT MAKES UP A COMPUTER SYSTEM? 


Generally a computer system consists of the following units: 

i) Central Processor Unit (CPU) . 

This can be considered the brain of the computer system. 
It performs operations specified in the instructions, such 
as arithmetic and logical operations. 

ii) Memory Unit — Information and instructions given by the 
user or generated by the computer are stored here. This 
unit is inside the computer. The CPU gets information 
from it directly. 

iii) Mass Storage Unit — This unit is outside the computer. It 

stores instructions and information given by the user or 
generated by the computer. The tape storage unit and the 
floppy disk units are examples of mass storage units. 
Information stored in these units has to be transferred to 
the memory unit before the CPU can process it. 

iv) Input Device — As the name suggests this allows the user 
to enter instructions or information to the computer. The 
keyboard is an example of an input device. 
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v) Output Device — This receives information or results sent 
from the computer. Examples are the printer and the TV 
screen. 

The input and output devices together act as a two-way 
communication channel between the computer user and the 
computer system. 

Although computer systems vary in size, all practical 
computer systems require the above mentioned units. 


computer 


T Vor MASS STORAGE 


Video Monitor 





DISK 


output device 


MASS storage device 


memory unit 






ASCII 
KEYBOARD 














input device 
CASSETTE 
Era: TAPE UNIT 
output device MASS storage device 





Configuration of a Computer System in general 
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WHAT IS A PROGRAM? 


A program is a set of instructions. The process of specifying a 
set of instructions for a computer is called programming. The 
individual preparing a program is called a programmer. The 
programmer ‘inputs’ a series of instructions (program) which 
tells the computer the steps to take to complete the task 
required of it. 


COMPUTER LANGUAGE 


There are two steps involved in preparing a program for a 


computer. First the programmer must know what instructions 
to specify and the order in which to specify them. Second, he 
must be able to communicate his instructions to the computer. 
Communication is accomplished by means of a programming 
‘language’ which the programmer writes, and the computer 
‘reads’. | 

There are many programming languages in use today. Some 
are designed for very specialised applications. Others are de- 
signed for more general use. BASIC is a language in the latter 
category. | 


BASIC 


BASIC, an acronym of Beginners’ All-Purpose Symbolic Instruc- 
tion Code, is a powerful programming language. BASIC has a 
simple English vocabulary, few grammatical rules and it resem- 
bles ordinary mathematical notation. To instruct your com- 
puter you must know BASIC. It will be introduced gradually 
and explained at each step. | 

Programs written in BASIC are translated by a language ~ 
translation program into a language that the central processor 
unit understands. This language translation program is called the 
BASIC Interpreter, and is contained in the main console. 
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TO START | 
When you have set up your color computer and switched it on, 
your TV screen should look like this. 





READY tells you that the computer is waiting and as the 
word suggests is ready to receive your instructions. The flashing 
green square, the CURSOR, tells you exactly where you are on 
the screen. 
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HOW TO OPERATE THE KEYBOARD? 


The keyboard of your computer looks complicated but it is 
really not too difficult to operate. 


Let us take the[ 9| key as an example. To get the number 
9 just press the key. If you wish to get READ, press the 
key and at the same time press the[9| key. If you wish to get 
the bracket on the| 9 | key, press the key and at the. 
game time press the [9] key. To get £.3S(, which is below the 
[9] key, is a little more complicated. First press the key 
. and keep pressing while you press the key once and 
then press the| 9] key. ABS( will appear on your screen. All it 


takes is a little practice. If you are wondering ‘‘What would 
happen if | did .... ."” Go ahead and do it and find out for 
yourself. | | 


NOOOOoOCoROD: 
NOOOOOOOOCE 


i a a a A 
Ea ee ee ee 
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Chapter 2 


PRINT AND |RETURN 


You instruct your computer using the language of BASIC. The 
computer can obey at once, or it can store the instructions and 
run them later as a program. Let us now instruct the computer 
to act at once. To do this, we need our first two words from the 
BASIC language: | 









NooooooOoooOD» 
OCOOOOOOOOR = 
Nooonooooboo0o0o 
mM ooooooooonl 
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When using these ot\any ‘other statements you can type out 
each letter, e.g. P, R, 1, N, Tor you can just press the appro- 


priate combination of keys, in this case |CTRL| and [P] to get 
the Keyword. Try it out on your computer. 


When you type PRINT the computer knows that it has to 
print what follows on the screen. 


For example, type PR/NT 6-3 and the screen should look 
like this. 


PRINT6-3 





Notice that when you press a key there is a (BEEP) sound. 
This tells you that the key has registered and is helpful in that 
you do not constantly have to check the screen. 


Now press |RETURN| and your screen should look like this. 


PRINT 6-3 [RETURN] 


3 
READY 
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By pressing the [RETURN] you have told the computer 
that the message is completed and you want the line executed. 


Remember then to press |RETURN} after each completed 
message. 


SYNTAX ERROR 


You may find the following appear on your screen. 


? SYNTAX ERROR 
i 





This means SYNTAX ERROR. A syntax error is usually due 
to incorrect punctuation or a typing error. 
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Suppose you type in PR/IMT 6-3. and then press the 


RETURN key your screen will look like this. 


PRIMT 6-3 | RETURN | 


2? SYNTAX ERROR 


READY 
a 





In addition to SYNTAX error there are a number of other 
errors that may occur, the various error types are listed in an 
appendix. 
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EDITING | 
If you make a mistake while you are entering a program state- 
ment, and you press the [RETURN] key, you can use the 


CTRL| and the appropriate key to move the cursor back to 
the wrong entry to make a correction. 


PRIMT @ 





When the cursor is over T press CTRL} and |RUBOUT). T 


will disappear. Move the cursor over M. Depress | CTRL] and 


| RUBOUT] again M will disappear. Then type in NT — TO GET 


PRINT. 
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There are four directions in which you can move the 
CURSOR: left, right, up, down as indicated by the black 
arrows on the keyboard. You will find these on the bottom 
right hand corner of your keyboard. 

Let us take an example. If you have typed in a line, then 
the CURSOR is at the right side of the screen. Let us suppose 
you have made a mistake at the beginning of the line. You want 


to delete a WORD. PRESS the| CTRL| key and the [M| key. 


Keep both pressed until the CURSOR has moved back to where 


you want it. Then press the | CTRL| key and |RUBOUT}] and 


keep pressed unti! the line is erased. 


HELLOJOHN @ 
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* You want to eliminate JOHN. Move the CURSOR to J. 
Press and [RUBOUT]. Keep pressed and see what 
happens. 

It is also possible to type in a letter over another letter. Let 
us suppose you want to change JOHN to JAMES. Position the 
CURSOR over O. Type in AMES. and you get JAMES. 


Suppose that after having typed HELLO JAMES you decide 
to change the name again. However this time suppose the 
CURSOR is at a lower line. Well all you do is to press |CTRL 
and the key|- |. You will find that the CURSOR will move up — 
to the line you want to change. Each time you press these two 
keys the CURSOR will move up one line. Once you have 
reached the line you wish to edit you can just carry on the 
same way as the example. above. 

To familiarise yourself with editing you need to experiment 
with it. Here as elsewhere the old adage holds true: Practice 
Makes Perfect. 
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INSERT 


This allows you to insert characters starting at the position the 
~ CURSOR is in without changing what is already there. For 
example: you wish to insert S in JOHNTON between the N 


and the T. 
Well you move the CURSOR to the first T, press the | 


CTRL| and keys (which will put you into the INSERT 


Mode) and then type S. Your display should now look like this: 


JOHNSTON 


Besure to press |RETURN| after you finished editing. 


- This will update the current line where the CURSOR is located. 
If you forget to do so, the original line is still kept in the 
program. 


CLS 


As you have guessed by now |CTRL}| means control. If you 


want to clear the whole screen, press |CTRL| and|CLS| at the 
same time and then press | RETURNI. This will clean the screen 
but it will not clean the memory. The program will be wiped 


out from memory if you press [CTRL] and [NEW]. It will also 


be wiped out if you disconnect the computer. 
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A LOOK AHEAD 


At this stage you are probably very eager to jump ahead and 
see what your computer is capable of. So using your newly 
acquired ability to try typing in these programs. 

Be careful to type in everything. Do not worry about 
understanding the commands at the moment. | 
1) To get all the characters on the screen type this. 


FOR!1=0TO1 
FOR J=0.TO 255 


POKE 28672 + 1*256+J,J |RETURN 


NEXT 
NEXT 
GOTO 60 | 
RUN | 





2) To see some of the color possibilities: try this one. 


19 MODE (1) 

20 FOR Y=9TO 15 

30 FORX=1T04 

40 COLORX [RETURN] 

50 FOR K=9T031 

60 SET (X* 32 —32+K, Y) 


70 NEXT 

80 NEXT 

90 NEXT 

100 GOTO 100 
RUN 
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To return to Text mode type ICTRL| -|BREAK'). 


If you would like to change your background color you 
should type COLOR,1. To return to the original green just 
type COLOR,@. Note that when you do this in mode 1 the 
foreground colors will also change. All these will be explained 
later. - 
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SIMPLE INSTRUCTIONS 
To use the computer as a calculator simply type PRINT fol- 
lowed by the problem and then RETURN. Your computer, 


of course, cannot only add, using +, but it can also subtract 
using —, multiply using *, divide using / and raise one number 
to the power of another using t. +, —, *, /, are called opera- 
tions, and they operate on numbers called operands. 


For example type 


PRINT 3% 2 |RETURN 





and the answer 9 will appear. 


ORDER OF NUMERIC OPERATIONS 


When operations are combined, care must be taken to note the 
order in which the computer carries out the operations. The 
order is as follows: 

1) Minus sign — used to indicate negative numbers. 

2) Exponentiation starting at the left and moving right. 

3) Multiplication and division (which are given the same order © 
of precedence). Here too the computer moves from left to 
right. 

4) Subtraction and addition moving from left to right. 


Se ee ; 


Examples: A) PRINT 3 t2t2t2 RETURN: 
6567 
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This is done by squaring 3 to get 9. Then 
squaring 9 to get 81, and then squaring 81 
to get 6561. | 


B) | PRINT6 *2+3 


15 | 
Here the computer first multiplies 6 x 2 and 
then adds 3. 


C) |PRINT6+3*4+6 [RETURN| 
20 


First the computer carries out the multi- 


plication and division and then adds to give 
Oe 122: 


BRACKETS 


All operations within brackets will be carried out first before 
the other operations. . 


Example: 


PRINT 18/3 +3) |RETURN 
3 





Where brackets are placed within brackets the innermost 
brackets are calculated first. 


Example: | PRINT 20/1 + (3+ 2)) [RETURN 
: | 
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Chapter 4 


CONSTANTS 


In the previous chapters we have been using constants. A 
constant is, of course, something which does not change and 
can be either positive or negative. The number 6.32 is a con- 
stant. Moving onto 6.33 just gives a different constant. 
The range of a number in the computer is —10* < x < 198. 
The lowest positive number is 10° * 


VARIABLES 


A variable, as you might surmise, is something which changes. 
In Y = X + 3 both X and Y are variables as they have many 
possible values. A variable can be denoted by any letter of the 
alphabet, any two letters, or by a letter and a number providing 
the letter comes first. For example, A, AB, A6. 

The variable name can be any length but only the first two 
characters will be recognised by the computer. For example, the 
computer will consider HELLO MR BLOGGS to be the same 
variable as HE. 

A variable name cannot be any of the command words like 
LET or PRINT. 


LET 


The command LET can be used to assign a value to a variable. 
If a variable is not assigned a value it is held to be equal to zero. 
The variable will keep its assigned value until another LET, 
READ or an INPUT command is used to change the value. 


Example:; LETA=7 |RETURN 
LETB=9 |RETURN 


PRINTA+B |RETURN 
16 
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In BASIC the = sign does not mean the same as it usually 
does but tells the computer to give the value on the left hand 
side the same value as the right hand side. 

The left hand side of the statement must always be a 
variable. 

Have a look at the next example. 


Example: | LETA=2 [RETURN| 
LETB=3 |RETURN 
LETC =20 |RETURN 


LETA=2+A |RETURN 
LETD=3+D |RETURN 
PRINT A;8;C;D |RETURN 


43 20 3 





In the fourth line we see that A is assigned a new value of 
2 plus the old value of A which was also 2 giving a total of 4. 

In the fifth line we see that D is given the value 3 +D, as 
zero is the value given to any variable without an assigned value. 

Note that in your computer it is not strictly necessary to 
use LET to assign a value to a variable, and A = 7 will carry 
out the same function as LET A= /. 


SEMI-COLONS, COMMAS 


If more than one item is included in a PRINT statement the 
items should be separated by either a (,) or (;). Note the use of 
the semi-colon in the PRINT statement above. This causes the 
results to be printed immediately after each other with a space 
in between. When we use the semi-colon with strings there is no 
space. 
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A comma causes the result to be printed as follows. Think 
of your screen divided up into 2 sections of 16 characters. A 
comma will cause the first result to be printed at the beginning 
of the first section — on the left side — the second result to be 
printed at the beginning of the second section. The third result 
will go back to the first section and will be printed under the 
first result. If a result is longer than 16 characters it will overlap 
into the next section. The next result will ignore this section 
and start at the beginning of the following one. 


COLONS 


lf you have more than one statement on a line vey must 
separate them by using colons. 


Example: | 70 FOR/=1T05: PRINT /;: NEXT|RETURN 


RUN |RETURN 


123465 





Lists of PRINT Statements 


If you type} 70 PRINT 4 |RETURN 


20 PRINT6 |RETURN| 
30 PRINT 8 [RETURN | 





RUN |RETURN 


Your screen will show 
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Semi Colons at the end of PRINT Statements 


If you type| 70 PRINT 4; 
20 PRINT 5; 
| 30 PRINT 6; 
RUN 


Your screen will show 







4 5 6 
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OK, so now let’s try some simple programming. In the last few 
chapters we have been dealing with “immediate execution” — 
with the computer obeying immediately. We now want the 
computer to store statements so that they can be executed 
later on — ‘‘deferred execution”’. 


INPUT 
Have a look at this program. 





12 REM RAISE TO THE POWER OF 3 |RETURN 
20 INPUT A |RETURN 


30 PRINTA;At 3 





The INPUT in line 2@ asks you to assign a value to the . 
variable A. When you run this program, a question mark ‘’?”’ 
will display. The computer will wait until you type in a value | 
for this variable A. 


Notice that each line begins with a number. These numbers 
tell the computer not to obey immediately but to store away. 
The line number governs the order in which the line will appear 
on the screen. It is useful to write the numbers in tens as new 
lines can be later fitted into any part of the program by giving 
it a value of say 15 or 25. The range of possible line numbers is 
from @ to 65529. | | 


REM 


The REM in line 1@ is simply there to remind you later on of 
the purpose of the program. The computer will ignore it. The 
REM statements use memory space so if you are short of space 
you can delete REM statements. | 

The INPUT statement in line 2@ tells the computer (when 
the program is being run) not to execute until the variable 
value(s) have been typed in. 

The PRINT statement has already been met. 
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NEW and RUN | 
So how do we feed the program into the computer. Well first 


press the [NEW] key and [RETURN). This will wipe out any 


Old programs and variables. Remember the NEW command 
clears the memory of the computer. 
Now type 


12 REM RAISE TO THE POWER OF 3 |RETURN 


20 INPUT A 
30 PRINT A;At 3 


You can now run the program by pressing |RUN| and 


RETURN]. The sign ? will now appear under line 3Q. This is 


the result of the INPUT statement and the computer is now 
waiting for you to give a value to the variable A. This value 
should be typed next to?. } 


Let’s type 2 and RETURN 


The screen will look like this. 





12 REM RAISE TO THE POWER OF 3(RETURN 


20 INPUT A |RETURN 
30 PRINT A;At 3 [RETURN 


RUN |RETURN 


? 


2 [RETURN 
2 8&8 
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RUN 


By pressing |RUN|and [RETURN] the whole program will be 


executed. If however you press| RUN |then a line number then 


RETURN; the computer will start execution at the line 


specified. 
Have a look at this program 


10 INPUTA,B 
20 PRINTA+B 
RUN 







What will happen here is first of all you will get one ‘?’ for 
you to put a value of A beside. On the next line you will get 
‘2?’ for you to put the value of B beside. So carrying on with 
- the program above. 


19 INPUTA, B 
20 PRINTA+B 
RUN 


? 


3 [RETURN | 
ad 6 |RETURN 
9 
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LIST 
If you want the whole program to be displayed in an ascend- 


ing line number order then just press|LIST/and |RETURN). 


Example: INPUT A .;RETURN 
INPUT B |jRETURN 


“PRINT A; B;C;A+B+C |RETURN 


INPUT C |RETURN 





LIST 


10 INPUT A 
20 INPUT B 
25 INPUT C | 
30 PRINTA;B;C;A+B+C 






If you only want one line to be displayed then type 


LIST (Line number) |RETURN 


Example: | L/ST 20 |RETURN| 





20 INPUT B 
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To list part of a program say line 20 — 30 type 





LIST 20 — 30 


20 INPUT B 
25 INPUT C 
30 PRINTA;B;C;A+B+C 






If you type L/ST — 30 you will get the program listed up to 
line 30 from the start. | 

If you type L/ST 30 — you will get the program listed from 
line 30 to the end. 
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- 


PAUSE IN LISTING 


If you have a very long program you might wishtohave a look 
at a particular line while it is being listed. To do this just press 


the |SPACE| key when you wish the listing program to stop. 


DELETING A LINE 
To get rid of any program line just type the line number and 


[RETURN]. 
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WHAT IS A FUNCTION? 


A function is a ‘law’ which when applied to a certain value will 
give a new value. We call the first value the argument and the 
new value the result. 

SOR is the square root function. So if we type 


PRINT SOR (9) 


we will get the answer 3. 

In this example 9 is the argument, SOR is the function and 
3 is the result. 

Below we give a list of the numeric functions and a brief 
explanation. Any function which we consider to be new to the 
reader will be explained in more detail afterwards. The func- 
tions will appear later on in programs so we don't ge example 
progres for each one. 


A LIST OF NUMERIC FUNCTIONS 


Function What it does 
ABS (X) Returns the absolute (positive) value of X 
SGN (X). Returns the sign of the argument 


X negative returns — 1 
X positive returns + 1 
X zero returns @ 


SOR (X) Returns the square root of X. X cannot be 
negative. 

LOG (X) Gives the natural logarithm of X. The value 
of the argument must be greater than zero. 

EXP (X): Gives you the value of e*. e = 2.71828 

INT (X) Gives the greatest mtg which is less than 


or equal to X. 
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RND (X) Gives random whole numbers between 1 
and X. If X equals zero RND (X) returns 
random numbers between @ and 1. X can- 
not be negative.’ 


SIN (X) The argument of the trigonometrical func- 

COS (X) tions is in radians. The range of X_ is 

TAN (X) —9999999 < (X) < 9999999. 

ATN (X) This gives the result of ARC TANGENT in 
RADIANS. 


A FURTHER LOOK AT ABS : SGN - INT: RND 


ABS (X) 


This gives the absolute (positive) value of the argument. So 
ABS (—7) = 7. 


Example: | PRINT ABS (7 —2* 4) [RETURN 
1 





SGN (X) 


This function will give the value of +1 if X is positive, @ if X 
is zero, and —1 if X is negative. So SGN (4.3) = 1; SGN (0) =0, 
SGN (—.276) = —1. 


Example: | A=—6 |RETURN 


PRINT SGN (A); SGN (A —A) |RETURN 
—-1 @O 





INT (X) 


This converts arguments which are not whole into the largest 
whole number below the argument. So /NT (5.9) = 5, also 
INT (—5.9) = —6. 


50 





Chapter 6 


Example: | PR/NT INT (—6.7) [RETURN 





RND (X) 


This will produce a random number between 1 and X if X is 
positive. 


Example: | PRINT RND (79) |RETURN 





You will get a number between 1 and 19. RND (9) will give 
you a number between @ and 1. | 


X cannot be negative. 


51 


52 





CHAPTER 


_ STRINGS 


— STRING VARIABLES 
— STRING FUNCTIONS 

LEN 

STR$ 

VAL 

LEFT$ 

RIGHTS 

MID$ 

ASC 

CHR$ 
— STRING COMPARISONS 
— INKEY $ 


53 


54 


Chapter 7 


We assume that you are now familiar with the use of the 


RETURN | key so we will not keep reminding you of it. 


A string is any combination of CHARACTE RS. that is 
treated as a unit. 
Strings must be enclosed in inverted COMMAS. 


Example: | “HELP” | 


When using the PRINT statement the semi-colon will not 
cause a space to appear between the results. They will appear 
immediately next to each other. | 


STRING VARIABLES 


Any letter of the alphabet can be used as a string variable but 
must be followed by a $ sign. The computer accepts these 
characters as the variant name. 


Example: | A$ = “ONE DOZEN EGGS” | 


You can add strings to each other. This is called concatena- 
tion. You cannot subtract, divide or multiply. 
Now let us try out this program. 


1D AS = aay fre 
20 BS = “Nf 15 YE” 
30 C$ = “ARS OLD” 


49 PRINT A$ + B$+C$ 
RUN 
|/AM 15 YEARS OLD 





Notice the spacing of the string characters here. 
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STRING FUNCTIONS 


We can also use functions to act on strings. Have a look at the 
following: 


LEN 


This function works out the length of the string so if you 
type, PRINT LEN (“JOHN”) the computer will return the result 
4. This is telling you that there are 4 CHARACTERS in the 
string ‘““JOHN’’. Blank spaces have the value of aCHARACTER. 
Thus if-you put in spaces “J O H WN” it comes out as 7 


CHARACTERS. 


STR$ 


The STR$ function changes numbers into strings. Let us take a 
look at the following example and see how it works. 


A$ = STR$ (73) 


This is the same as saying 


A$ — SW ae il 


Here is an example program 


10 A$ = STR$ (7 * 3) 
20 BS =A$ + “BIG” 
30 PRINT B$ 


RUN 
271 BIG 
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VAL 


VAL works like STR$ but in reverse. It changes strings into 
numbers. If only works on numbers not on operators or 
characters. 


VAL (“61”) =67 


Look at the following short program 


10 A$ = “33” 
20 BS = “20” 
30C =VAL (A$ + BS) 


49 PRINT C; C + 100. 
RUN 2 
3320 3420 





SUBSTRINGS 


It is also possible to get substrings of strings. A substring is as 
you might guess a part of a string. For example: ‘‘ASC” is a 
substrung of ““ASCDE”. 


LEFTS (AS, N) 


This will return the substring from the leftmost CHARACTER 
— the first character — to the Nth CHARACTER. 


Example: | 70 A$ = “ABCDE” 
20 BS =LEFTS$ (A$ + “FGH”, 6) 


30 PRINT BS 
RUN 
ABCDEF 
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RIGHTS (AS, N) 


This will return a substring as in the above example but starting 
from the Nth CHARACTER from the end and running to the 
last one — the right most CHARACTER in the string A$. 


Example: | 70 A$ = “WHY” 
| 20 BS = RIGHTS (A$ + “ME”, 4) 
30 PRINT B$ | 


RUN 
HYME 





MID$ | 


MID$ (A$, M, N) returns a substring of the string A$ starting 
from the Mth CHARACTER with a length of NCHARACTERS. 


Example: | 70 A$ = “ABCDEFGH” 
20 BS = MID$ (A$, 2, 3) 


30 PRINT B$ 
RUN 
BCD 
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ASC 


The ASC statement which is written as ASC (A$) where A$ is 
a variable string expression, will return the ASCII code (in 
decimal) for the firsts CHARACTER of the specified string. 
Brackets must enclose the string specified. Refer to the appen- 
dix for the ASCII code. For example the ASCII decimal value 
of “X" is 88. If AS = “XAB”, then ASC (B$) = 88. 


Example: | 70X =ASC (“ROY”) 
20 PRINT X 


RUN 
82 





CHR$ 


This statement works the opposite way around to the ASC 
statement. The CHR$ statement will return the CHARACTER 
of the given ASCII code. The argument may be any number 
from @ to 255 or any variable expression with a value within 
that range. Brackets must be put around the argument. 


Example: | 30 PRINT CHR$ (68) 
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STRING COMPARISONS 


Relational operators can be applied to string expressions to 
compare the strings for equality or alphabetic precedence. As 
far as equality is concerned all the characters (and any blanks) 
must be identical. 


Example: | 70 A$ = “AA” 
20 BS = “BA” 
30 IF A$ = B$ then PRIN T 20 
40 IF A$ < B$ then PRINT 30 


50 IF A$ > B$ then PRINT 40 
RUN | 
30 





The comparisons are done by taking the value of the string 
characters from the table in the appendix and then comparing 
these values. The table gives us the value for ‘A’ as 65 and ‘B’ 
as 66. The program above is therefore asking for confirmation 
that 65 is less than 66. 

If the first two CHARACTERS of a string are acuial the 
computer will search for the third CHARACTER and do the 
comparison on this. 


Example:| 10 A$ = “ABC” 
20 BS = “ABD” 
30 IF BE > A$ then PRINT 49 


RUN 
4D 





The CHARACTERS compared here are C and D. The table 
value of C is 67 and the table value of D is 68. B$ is therefore 
greater than A$. 
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INKEY$ 


INKEY$ returns either a one-character string containing a char- 
acter read from the keyboard or a null string if no character 
is pending at the keyboard. All characters are passed through 
to the program except for Control-C, which terminates the 
program. 


Example: 10 A$ =INKEY$ 
20 PRINT A$; 





30 GOTO 10 
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Here are some more commands to help you write more interest- 
ing programs. 


GOTO 


This command tells the computer to go backwards or forwards 
to the line number following the GOTO statement and then to 
carry on executing the program from that line number. 


Example: | 70/NPUTA 
20 PRINTA,At* 3 
30 GOTO 10 


RUN 
? 





If you give the value say 2 to A the computer will return the 
results 2 and 8. However a question mark will again appear on 
the screen asking you to give A another value. This procedure 
is the result of the GOTO statement tells the computer not to 


~ end at line 3@ but to go back to line 19 and start again. 


BREAK 


When you get tired of putting in different values of A you 


can press |BREAK| next to the question mark. The computer 
will now stop executing the program and BREAK /N 70 will 


appear on your screen. It should be noted that [BREAK |is not 
a command as such. You can break any continuous program by 


implementing [BREAK]. 
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CONT 


If however, after stopping the program execution you feel 
there are still some values of A you would like to try you can 
type CONT, and the computer will start to execute the program 
once more. 7 


STOP 


A useful statement in programming is STOP. This causes 
the program to stop at the line printed after the STOP state- 
ment and can help you to examine the results of the variables 
at various stages in the program. It is also extremely useful 
when it comes to locating mistakes (debugging). A liberal 
supply of STOP statements throughout a program is therefore 
a good idea. 


You can restart the program by typing CONT. The program 
will carry on from the next line after the STOP. 


END 


The END statement is used to terminate execution. Unlike with 
STOP execution cannot be continued after an END statement. 


Example: | 70 /NPUTA 

20 IF A> @ THEN PRINT “A IS POSITIVE”: 
END 7 

30 IF A<@ THEN PRINT “A IS NEGATIVE”: 


END 
49 PRINT “A IS ZERO” 
50 END 


NOTICE the STOP statement will give you the line number 
when you stop. This will not happen with the END statement. 
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CLEAR 


The CLEAR statement is used to assign more memory spaces 
for string variables. | 


Example: | 70 CLEAR 100 


The value following is the number of bytes of memory. This 
value may be omitted and the computer will assign the default 
value. If you want to use more strings in your program, set this 
number to a larger one but you will have less spaces for your 
program. 7 
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IF... THEN... ELSE 


As we make our way through BASIC, we find that we gain more 
control over the computer, that is, we are able to do more with 
_the computer. In this chapter we are going to take a look at the 
“IF... THEN...ELSE” statement. This is, perhaps, one of 
the two most important programming concepts in BASIC. The 
other one is “FOR...NEXT”. We will look at this in the 
following chapter. 


Let us look at this example. 


60 IF A$ > B$ THEN PRINT A$ ELSE PRINT B$ 


This tells the computer that if the expression A$ is greater 
than B$ to carry out the statement PR/NT A$ and if not to 
carry out the statement PR/NT BS. 


CONDITIONAL BRANCHING 


A condition is made up of: 

An expression, a relation and an expression. 

Any BASIC expression may be used but the expression 
must be of the same type, that is either both numeric or both 
string expressions. 

Relations or comparisons Aieed in the IF... THEN state- 
ment are the following: ,  * 


= Equal to 

< = Less than or equal to 

< > Not equal to 

> = Greater than or equal to 
< Less than 
> Greater than 


Here are some more examples of how we can use condli- 
tionals. 
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IF....THENA=B 
IF .... THEN GOTO 
IF ..... THEN GOSUB 
IF .... THEN PRINT 
IF .... THEN INPUT 


Example 1:|30 /F X > 25 THEN 60 | | 


If the statement is not true, that is, if X is not greater than 
25 then the computer simply carries on with the normal line 
number order in the program. Notice that it is not necessary. to 
use the ELSE part of the COMMAND here as this is optional. 


Example 2:| 70 INPUT A, B 
2DIFA>BTHEN 50 . 
30 IF A< B THEN 60 
140 /F A =B THEN 70 
50 PRINT A; “IS GREATER THAN”; B: END 
60 PRINT A; “IS LESS THAN”; B: END 


70 PRINT A; “IS EQUAL TO”; B 
80 END 
RUN . 
? 7 
?? 3 
7 IS GREATER THAN 3 
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Example 3:|40 IF P=6 THEN PRINT “TRUE” ELSE PRIN 
“FALSE” 


In this example if P = 6 the computer will print TRUE. 
Any other value will produce a FALSE. In either case the com- 
puter will carry onto the next line. 


It is possible for more than one statement to follow the 
THEN or ELSE command. , 






Example 4:|5@ /F A =5 THEN PRINT “TRUE”: S=S — 3: 
GO TO 90 ELSE PRINT “FALSE”: K =K +8 


So if A equals 5 the computer will print TRUE, SUB- 
TRACT 3 from the variable S and go to line 9@. If A does not 
equal 5 the computer will print FALSE, and add 8 to the 
variable K. 


LOGICAL OPERATORS 


Logical operators are used in IF... THEN...ELSE and such 
statements where condition is used to determine subsequent 
operations within the user program. The logical operators are: 

AND, OR, NOT. | 


For purposes of this discussion A and B are relational 
expressions having only TRUE (1) and FALSE (@) values. 
Logical operations are perionmes after arithmetical and rela- 
tional operations. 
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Operator Example Meaning 
NOT NOTA If A is true, NOT A is false. 
AND . A AND B A AND B has the value true, only if 
| A and B are both true. 
A AND B has the value false if 
~ either A or B is false. 
OR A ORB A OR B has the value true if either 
A or B or both are true. 
It has the value false if both are 
false. 


TRUTH TABLES 


The following tables are called TRUTH TABLES. They 
illustrate the results of the above logical operations with both | 
A and B given for every possible combination of values. 


TRUTH TABLE FOR “NOT” FUNCTION 


A NOTA 
T OF 
F T 
TRUTH TABLE FOR “AND” FUNCTION 

A B A AND B 

TO OT TO 

T OF F 

FOOT F 

FOF F 


Note that T = TRUE and F = FALSE. 
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TRUTH TABLE FOR “OR” FUNCTION 


A B AORB 
T OT T 
TF T 
F OT T 
FOF F 


NOTE: T-—TRUE 
F — FALSE 





Example: | 70 /NPUTA, B,C 
20 IF A =B AND B =C THEN PRINT “A=B=C” 
30 IF (NOT A = B) OR (NOT B =C) THEN 50 
40 END | 
50 PRINT “A =B=C 1S FALSE” 


69 END 

: AUN 
| ? 610 
5 


?? 
?? 7 
A=B=CI/S FALSE 





75 


76 


CHAPTER 


LOOPING 


—FOR...TO 
— NEXT 
— STEP 


77 


78 


Chapter 10 


FOR....TO....NEXT.... STEP 


Often we need the computer to perform repetitive tasks. The 
looping process enables us to do just this without having to type 
in similar information many times. | 

For example if we want many numbers cubed and then 
_ divided by 3 we don’t have to type in various values; all we have 
to do is this: 


Example:| 70FORX=1T010 _— 

20 PRINT X;X t 3/3 

30 NEXT X 

49 END 

RUN 

333333 
2.66667 
9.00001 
21.3333 


72 
114.333 
170.667 
243 

1D = 333.333 


1 
2 
3 
4 
5 41.6667 
6 
7 
8 
9 





From the above example we can see that the computer has 
cubed and divided by 3 numbers between 1 and 10. The FOR 

. TO statement, therefore, stipulates the range of numbers 
you wish to act on. 

You will notice that the increments of the numbers were 
one each time. The increments can be changed by using the 
STEP statement and a positive number. If a negative number 
follows the STEP statement we will get a decrement. It is also 
possible to use a decimal, as expression or a variable. 
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Example: | 70 FOR X=1 TO 10 STEP 2 
20 PRINT X; X t 373 


30 NEXT X 
49 END 
RUN 





This will act on all the odd numbers between 1 and 1@ and 
your screen will show the following numbers: 


SS3S333 
9.00001 


41.6667 
114.533 
243 





You will also notice that each loop must be closed with a 
NEXT statement. The variable name of the NEXT statement 
must be the same as the variable name of the FOR statement — 
in this case X. On your computer the variable name following | 
the NEXT statement can be omitted. 

Loops are very useful for writing tables as you will see from 
the following example. 
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Example: | 70 REM TO PRINTA SINE AND COSINE TABLE 


20 PRINT “SIN (X)”, “COS (X)” 
30 FOR X =O TO2ZSTEP 0.5 

49 PRINT SIN (X], COS a. 

50 NEXT X 

60 END 


RUN 


SIN (X) COS (X) 
D 1 
479426 877582 - 
841471. 540302 


.997495 0707371 
.9D9298 .416147 





If you do use a variable name following your NEXT state- 


ment and you use 2 loops you must be careful not to cross your - 
loops. . 


Example: 


69 NEXT X 
70 NEXT Y 





This causes crossed loops and will result in a NEXT 
WITHOUT FOR error message. The correct way is as follows: 
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E NEXT Y 
70 NEXT X 





This gives you the nested loop for Y inside the loop for X. 
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GOSUB — RETURN 


A program has a beginning and an end. It has a structure. This 
structure is made up of smaller building blocks. You may need 
some of these blocks or sections of the program many times in 
various places in the overall program. To help us deal with these 
similar smaller parts of the program we can use subroutines. The 
statements we use are GOSUB and RETURN. 





19 PRINT “HELLO” 
20 GOSUB 50 

30 PRINT “GOODBYE” 

49 END 

50 PRINT “HOW ARE YOU?” 
60 GOSUB 80 

70 RETURN 

80 PRINT “SEE YOU” 

99 RETURN 

RUN 

HELLO 

HOW ARE YOU? 

SEE YOU 

GOODBYE 



















The lines are executed in this order 10, 20, 50, 60, 80, 90, 
70, 30, 49. You can see from this example how the GOSUB | 
statement works.......... | 

. . .. The GOSUB statement tells the computer to move on — 
to the line number indicated, that is to the line number follow- 
ing GOSUB. However unlike with the GOTO command the 
GOSUB command makes the computer come back again to the 
statement that immediately follows the GOSUB statement. 

The computer will carry on with the subroutine until the 
RETURN statement is met. It is the RETURN statement that 
makes the computer go back to the statement following the 
GOSUB statement. a 
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For another example: 


20 GOSUB 69 tells the computer to jump to line 60. The 
computer will start executing at line 6@ until it meets a 
RETURN statement. On meeting the RETURN statement the 
computer will go back and start executing at the statement 
following the GOSUB statement in line 20. 

Have a look at this example and see if you can work out 
' what’s happening. 


IDFORX=1TO5 
20 GOSUB 60 
30 PRINT X;S 
49 NEXT X 
50 END 
60S=0 
70FORJ=1TO4 
8O0S=S+tJ 
90 NEXT J 
100 RETURN 
RUN 
10 
10 
10 
10 
10 
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ARRAYS AND DIM 


There are two types of variables — Simple Variables and Array 
Variables. Up to now we have been dealing with simple vari- 
ables. Let us now take a look at the Array type. 

An array is an organised list of values which provide an 
efficient way of handling large amounts of information. The 
values can be either numbers or strings. To set up an array you 
have to give the array a name and a size. The name can be either 
a letter or a string e.g. A$(5). 

It is easy to distinguish an ARRAY from a ainaale variable. 
The ARRAY variable is always followed by brackets containing 
a number. e.g. A(2), B(7), G5$(7). This number in the brackets 
is called a subscript. 


Why Use ARRAYS? 


Let us suppose you have a number of books at home — say 190 
books — and you want to index all your books. If we assign a 
variable to each book name for example: 


Example: | 10 A$ = “GONE WITH THE WIND” 
id BS = “OLIVER TWIST” 


'1000 Y$ = “BASIC PROGRAMMING” 





This would be very inefficient and time consuming. A better 
way of dealing with this list is to use an ARRAY, The variable 
A$ will stand for the list of books. Let us look at the following 
example: 
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Example: | 10 REM BOOK NAMES 
20 DIM A$ (100) 
30 FORX =1T0 100 


49 INPUT ‘WHAT NUMBER”, A$ (X) 
59 NEXT X 

RUN 

WHAT NUMBER? 





After you give a code to the question mark, ‘WHAT NUM- 
BER?’ will appear again underneath. This will carry on until 
your list is completed. 

Before you can use an ARRAY it Is necessary to use the 
DIM statement. Above we have DIM A$ (1@@). This tells the 
computer to reserve space for the ARRAY called A and that © 
the ARRAY has 101 subscript variables. It is possible at a later 
time to sort, rearrange or print out this set of data. This type of 
ARRAY is called a one dimensional ARRAY and it deals with 
lists. 

It is also possible to have a two dimensional ARRAY where 
we have two subscripts and we are dealing with numbers in the 
matrix form. 

DIM stands for dimension. 

Let us suppose we have 5 students doing 3 exams. The 
results of the exams look like this 


EXAM (1) EXAM (2) EXAM (3) 


STUDENT 1 50% 70% 90% 
STUDENT 2 63 42 36 
STUDENT 3 20 62 50 
STUDENT 4 70 75 84 
STUDENT 5 93 82 68 


These results can be recorded on the computer using a two 
dimensional ARRAY. We would have to start with the state- 
ment: DIM A(5, 3). Here 5 is the number of students and 3 is 
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the number of columns and in this case exams. So A(4, 1) will 


be 70. This is the score of the fourth student in the first exam. 

It is possible to have up to a three dimensional ARRAY — 
DIM A(3, 6, 2). The size of each dimension is limited by the 
memory size of the computer so remember; A(X) is a one 
dimensional array variable, A(X, Y) is a two dimensional array 


variable, and A(X, Y, Z) is a three dimensional one. 


Note that if you do not use the DIM statement the sub- 
scripts @ — 1@ are allowed for each dimension of each array 
used. 
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READ, DATA 


When it is necessary to enter a lot of information or data into a 
computer, using the INPUT statement can be very -time con- 
suming. To help us out here we can use the READ and DATA 
commands. 


Example: | 70 DATA 10, 60,70 80, 90 
20 READ A, B,C, D,E 


30 PRINT A; B; C; D; E 
RUN | 
10 60 70 80 WD 





The READ statement consists of a list of variables with 
commas between each variable. 

The. DATA statement consists of a list of expressions 
separated by commas. These expressions can be either numeric 
or strings. The READ statement makes the computer look up 
the value of its variables from the DATA statement. When the 
computer goes to READ first it will assign the first expression 
from the DATA list. The next time it goes to READ it will 
assign the second value — And so on. If the READ runs out of 
DATA you will get? OUT OF DATA ERROR. 


RESTORE | | 
If you want to use the same data later on in the program you 


can do so by using the RESTORE statement. 
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Example: | 710 DATA 7, 3,8,9 
20 READ A, B, D 
30 RESTORE 
49 READ X, Y 
50 PRINT A; B 


60 PRINT Xx; Y 
70 END 

RUN 

1 3 

1 3 








The RESTORE command makes subsequent READ state- 
‘ments get their values from the first DATA statement. 
Now see if you can work out what is happening here. 











Example: | 70 REM FIND AVERAGE 
20 DATA 0.125, 3, 0.6, 7 
30 DATA 23, 9.3, 25.2, 8 
490S=0 
50 FOR1|=1TO8 
60 READ N 
TOS=S+WN 
80 NEXT 


100 PRINT A 
RUN 
9.52813 





Now using our student’s examinations results from the 
chapter on arrays (chapter 12) see how the READ and DATA 
commands can be used. 
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12 CLS: DIM A(5, 3) 

20 PRINT “RESULT”: PRINT 

30 PRINT TAB(8); “EX(1) EX(2) EX(3)” 
40 PRINT 

50 FORJ=1TO5 

60 PRINT “STUDENT”, J; 


70 FOR 1=1 TO 3:READ A{J, 1): CAINE, I);: 
NEXT: PRINT 
80 NEXT 
99 END 
120 DATA 5G, 70, 90, 63, 42, 36, 20, 62, 50, 70,75 
110 DATA 84, 93, 82, 68 
RUN 
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PEEK (address) 


This PEEK function will return the value stored at the specified 
address in the memory of the computer. The value will be 
displayed in the form of a decimal. The value is in the range of 
@ — 255. | 


Example: | 30 A =PEEK (28672) 


This returns the value the program has at 28672 and gives 
this value to A. It should be noted that the address need not be 
a value it can be an expression. | ) | 


POKE address value, expression 


The POKE function complements the PEEK function. It sends a 
value to the stated address location. You need therefore an 
address and value, and again the value has to be between @ and 
255. | 


Example: 10 A=1 
20 POKE 29000, A 
30 B=PEEK (29000) 


49 PRINT B 
RUN 
/ 





When using this command we must be very careful as it can 
destroy your program. It is wise to save the program before you 
execute POKE., It is not recommended for newcomers without 
prior knowledge of what it does. You can only POKE to the 
Random Access Memory (RAM) that is to the place where 
the computer stores the information it wants to keep like your 
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BASIC program, variables, the picture for the television and the 
various musical notes. So may be the address you indicate may 
not be in the memory of the computer. The address is in the 
range of —32768 to +32/6/7. 


Screen locations for POKE and PEEK commands are hexi- 
decimal 70900 — 71FF (Decimal 28672 — 29183) in TEXT 
mode and 7000 — 77FF (Decimal 28672 — 36863) inGRAPHIC 
mode. Starting location is decimal 28672. 


2e672(T TTT ITT TIT 
28704 SU UEGE LAE GRGREEERTRREEnneneneee 
287361 | ITIL TTT TTT TT TT 

28768 PEECEEE EEE EEE 
288001 | TIT TITTLE TTT 
28832 (ere een a yee less 
28864) Oo). el eae tae ete stele 
288961 | | TTT Tit Tt 











29924| | |_ 


200881 | TT ttt TTT EE 
29120] | TT TTT TTT TTT tT TTT TE 
29152{ {TTT LITI TET itt 
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POKE 

10 CLS: SC = 28672 

20 FORI=1TO9 

30 READA 

49 POKE SC +1*32,A 

50 NEXT 

60 GOTO 60 

70 DATA 80, 79, 75,69, 32, 80, 69, 69,75 


TYPE |CTRL||BREAK | to break this program 


PEEK 

10 CLS: SC = 28672 

20 PRINT “PEEK” : PRINT 
30 FORI=0TO3 

40 PRINT PEEK (SC + 1); 
50 NEXT 
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Your computer has some different character codes to most 
other computers. They are shown below: 


NEW CHARACTERS CODE (FOR POKE & PEEK} 


(A) (A) (A) (A) 


@ 
A 
B 
C 
D 
E 
F 
G 
H 


Se eS IN ae OX SS SS a oe Oe 6 ee 
© ON OO BR WHDY = COC 


O22TRKC 


+ 
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(A) 1ST COL — CHARACTER CODE 
2ND COL — ASCII REPRESENTED 


FORA=@-63 © 
gives normal characters. 


By adding an offset 
A= @ — 63 (+ 64) = 64 — 127 
gives inverse characters. 


(A) (A) 


FOR A = 128 — 255 the codes 
are divided into 8 (graphic char- 
acters) groups each with dif- 
ferent color code. (The shaded 
area has color.) 
FOR A= 128 — 143 GREEN 

= 144-159 YELLOW © 

~ =160—175 BLUE 

= 176 — 191 RED 

= 192 — 207 BUFF 

= 208 — 223 CYAN , 

= 224 — 239 MAGENTA 

= 249 — 255 ORANGE 


| Re OD de oe 


CT 
r 
a] 
is 
L 
i 
| 
a 
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STORING PROGRAM ON TAPE 
(CASSETTE INTERFACE) 


— SETTING IT UP 
— C LOAD 

— VERIFY 

— C SAVE 

— C RUN 

— PRINT # 

— INPUT # 
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You may have developed some programs which you want to 
retain. It is too much trouble to type in a program, especially 
if it is long, every time you want to use it. This problem is 
easily solved. You can store your programs on tape and when- 
ever you need them call them into memory. 


SETTING IT UP 


To do this you need an ordinary cassette tape recorder, a 
cassette tape and interconnecting cords. Connect the recorder 
as shown tn the picture. 


COMPUTER CASSETTE RECORDER 
BACK OF UNIT ‘ 





You need to be familiar with three commands, namely, 
CSAVE, CLOAD and VERIFY. 

You have received a cassette tape with your computer. On 
one side of this tape there is a program and the other side is 
blank. It is suggested that you start by loading this program into 
the computer, 
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There is a file name for each program on the tape. A file 
name is a “must” for saving a program but not absolutely neces- 
sary for loading and verifying a program. | 

The file name can be one to sixteen characters in length. 
The first character must be a letter; the rest can be any 
character. 

For our purpose saving a program means transferring a 
program that you have typed in, to a tape. 

Verifying a program means checking to make sure that the 
program on the tape is the same as the program in the computer. 

Loading a program means transferring a program from the 
tape to the computer. | 


CLOAD “FILE NAME” 


The procedure for loading the program from the tape to the 

computer is as follows: 

1. Load the tape containing the required program into the 
recorder. | 

2. Rewind the tape to the start of the required program. 

3. Type the COMMAND CLOAD “FILE NAME”. 


BE SURE NOT TO PRESS THE |RETURN| KEY 


4. Press the play button on the recorder. 


Press the (RETURN | key. 


6. If the computer finds no program on the tape, the state- 
ment WAITING is displayed on the screen. If you want the 


computer to come out of WAITING, PRESS the |CTRL 


BREAK | keys before stopping the cassette recorder. 


7. \f the incoming program has the file name which does not 
match with the specified one, then the statement “FOUND 
T: FILE NAME’ appears and the program is skipped. 

8. The desired program is loaded with the statement “‘LOAD- 
ING T: FILE NAME’ appears. 

9. When the statement READY is displayed, press the STOP 
button on the recorder. 


ik 
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Let us suppose there are three programs on the tape and 
you have given them file names: PROGRAM 1, PROGRAM 2, 
PROGRAM 3. You want PROGRAM 3 and it is at the end of 
the tape. You can type: CLOAD “PROGRAM 3”. Then your 
screen will show: 


CLOAD “PROGRAM 3” 
WAITING 
FOUND T: PROGRAM 17 


FOUND T: PROGRAM 2 
LOADING T: PROGRAM 3 — 
READY 





If you know the location of PROGRAM 3 and you set the 
tape at the beginning of this program the screen will show: 


CLOAD “PROGRAM 3” 
WAITING 


LOADING: PROGRAM 3 
READY 





NOTE T: stands for TEXT file. 


VERIFY “FILE NAME” 


To verify a program on tape the procedure is as follows: 
1. List the program in the computer to make sure that the 


program still exists. 
2. Type the COMMAND VERIFY “FILE NAME” 


-~ BE SURE NOT TO PRESS THE RETURN KEY. 
3. Press the play button on the recorder. 


4. Press the |RETURN| key. The flashing CURSOR will dis- 


appear and the verifying begins. 


111 


Chapter 15 


Example: | verRiFy “PROGRAM 2” 
WAITING 
FOUND T: PROGRAM 1 


LOADING T: PROGRAM 2 
VERIFY OK 
READY 





The ‘OK’ statement tells us that the program on the tape is 
the same as the program in the computer. 


If the verifying is incorrect, the statement ‘Verify Error’. 


will be displayed on the screen. This statement shows that 
the program on the tape is different from the one in the 
computer. In this case the user should store the program 
and verify it once again. 

You can verify that there is a program on the tape by 


listening. If there is a program on the tape and you run it on 
the cassette recorder, the recorder will give out a distinctive 
sound. | 


CSAVE “FILE NAME” 


If you wish to save a program, make sure that you use a good 
quality tape. The quality of the tape can affect the quality of 
your recording. 


It is important to set the volume of the cassette recorder 


within a proper range. This range will vary from one recorder 
to another. The tone should be set to MAXIMUM level. 


Tis 


_ 


The procedure for storing/saving a program is as. follows: 
Type in the complete program. It is advisable to use a short 
program at the start. Longer programs can be saved once 
you have achieved success with a short program. 
Type in the COMMAND CSAVE “FILE NAME” 
Remember a File Name is a “MUST” for saving a program. 
BE SURE NOT TO PRESS THE KEY 
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Load the recorder with a good quality tape. 
Press the PLAY and RECORD buttons on the recorder. 


5. Press the |RETURN| key. 


The flashing CURSOR will disappear and the storing begins. 


nad 


6. When the flashing CURSOR reappears, the stoning is com- 
pleted. 
7. Press the STOP Buon on the recorder. 
The program that you typed in is now stored on a tape. To 
make sure that it is stored the user may verify this for himself. 


CRUN “FILE NAME” 


One more powerful COMMAND ‘CRUN’ can be used. This 
command is similar to ‘CLOAD’ except that the loaded program 
will start execution automatically after the loading is completed. 

The four cassette interface COMMANDS, CSAVE, VERIFY, 
CLOAD and CRUN help the user to save his programs, verify 
them, and get them back into the computer to execute. The 
user should pay attention to the volume level of the recorder. 
Cassette interface is a means of inexpensive MASS STORAGE. 


There are two more COMMANDS that the user should 
become familiar with. There are: 


PRINT # 

PRINT # “FILE NAME”, item list sends the values of the 
specified variables or data onto a cassette tape. It is under- 
stood that the recorder must be properly connected and 
set in record mode when this statement is executed. 


INPUT # 

INPUT # “FILE NAME” item list. 

Inputs the specified number of values stored on cassette and 
assigns them to the specified vanabie: names. 
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Example: | 10 PRINT # “KAM”, 1,2,3,4,5 
RUN 





The data 1 to 5 are saved in the data file ““KAM’’. BE SURE 
to put your cassette recorder in RECORD mode BEFORE 
execution. : | | 


Example: | 10 INPUT # “KAM”, A,B,C.D,E 
20 PRINT A:B:C:D;:E 


RUN 
FOUND D: KAM 
123 45 





The data in the data file “KAM” are assigned to the vari- 
ables A to E. BE SURE to put your cassette recorder in PLAY 
mode BEFORE execution. 


NOTE D: stands for DATA file. 


114 








CHAPTER 


GRAPHICS 


— MODES 
— GRAPHIC CHARACTERS 
- _ INVERSE 
- _ SET 
_ _ RESET 
A — POINT 


415° 
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MODES 


There are 2 different modes of screen display. Once the power 
is turned on, the computer is in the normal Text mode, MODE 
(0), with 32 characters multiplied by 16 lines. This displays 


64 x 32 Dots with 9 colors. It is best used when some low 


resolution graphics and text are required as the video output is 
more attractive and appealing. 


The user can switch to the High Resolution Graphic mode, 
which has 128 x 64 Dots and 8 colors by making use of the 
MODE (1) command. This mode provides extra-fine graphics 
and is very suitable for games purposes. | 

To get back to normal Text mode you should use the 
MODE (@) command. 


GRAPHIC CHARACTERS 


There are 16 graphic characters in your computer which can be 


typed by pressing the | SHIFT} key and any of the correspond- 


ing keys. These characters are useful for drawing pictures and 
graphs. 

Have a look at the program beneath to see how you can use 
these characters. 


Example: | 70 REMCOLOR 
| 20 FOR !1=1T0 52 
30 FORJ=1TO8 
49 COLOR J 


50 PRINT “a” 
690 NEXT 

70 NEXT 

80 GOTO 8 
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This example uses the graphic character shown in the pro- 
gram to plot some graphics. This example also shows all the 8 
different colors in the TEXT mode by using graphic character. 

This example only uses one grapnic character. For the rest 
of them, you may observe your keyboard to see where they are 
located. 


INVERSE 
The inverse characters can be produced by simply pressing 


the |CTRL!] and | INVERSE} keys. Your computer will remain 
in the inverse mode until the |CTRL| and |INVERSE|! or 
RETURN) key Is pressed. 


SET (X, Y) 


On your computer this is used when dealing with colors. It plots 
a dot at a specified location on the screen which is determined 
by the values of X and Y. The value of X can be from @ to 127 
and the value of Y can be from @ to 63. 
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RESET (X, Y) 
_ This is used to wipe out a point switched on by the SET com- 
_. mand. The X and Y. values determine the location of the point 
to be wiped out. This is done by making the point the same 
color as the background. 


POINT (X, Y) 

This tells you if a specific point has been fixed by the SET 
command. Usually it is used with the IF-THEN-ELSE state- 
ment. 


Like this: 


8D SET (40, 20) : IF POINT (49, 20) THEN — 
PRINT “YES” ELSE PRINT “NO” 


Here is another example of the use of SET and also one 
using POINT. 


Example of SET and RESET: 


19 MODE (1) : COLOR 2 
20 FOR!=0TO31 

30 SET (I, 1/2) 

40 NEXT 


50 FORI=@9TO31 
60 RESET (I, 1/2) 
70 NEXT 

80 MODE (0) 





This example will plot a diagonal line on the screen and 
then rub this line out. When this program is completed, the 
computer will return back to MODE (@), that is TEXT mode. 


NOTE: If you want to keep the computer in graphic mode, 
replace line 80 by: 80 GO TO 80. 


119 


Chapter 16 


Example of POINT: 





10 MODE (1) : DIM A(4) 
(20 FORI=1T04 

30 COLOR | 

40 SET (1,1) 

50 A(l) = POINT (1, 1) 
60 NEXT 


70 MODE (0) 

80 FORI=1T04 
90 PRINT A(I) 
100 NEXT 


This example will plot points on the screen with four colors. 
This command POINT will check the color of that point and 
hold this information in the array A(I). Afterwards, the pro- 
gram will print out the color of that point checked by the 
command POINT. 
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‘MORE COMMANDS AND INFORMATION 


— PRINT @ 

— PRINT TAB 
— PRINT USING 
— INP 

— OUT 

— USR 
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PRINT @ 


This command causes the output to be produced at a particular 
point on the screen. When dealing with the PRINT @ command 
consider your screen to be a grid divided up into 32 x 16 spaces. 
Therefore there are 512 possible positions. The command takes 
this form : 


- PRINT @ position, item list. 


The position can be a number, variable or arithmetic expression. 
The value must be between @ and 511. 


Example: | 69PRINT @ 60, 600; 


Notice the use of the semi-colon at the end of the state- 
ment. This stops the rest of the line from being rubbed out. 


PRINT TAB (expression). 


This command works in very much the same way as the TAB 
on a typewriter. In this case it moves the cursor to a particular 
point on a line. The value of the expression must be between 
® to 255 inclusive. If it is over 63 the cursor will move to the 
position that exceeds the maximum integer multiples of 64. 


49 PRINT TAB (6); 1; TAB (20); 1 
RUN 
/ 1 


Example: 
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PRINT USING string; item list 


This command is useful in allowing you to state how you want 
your lines printed. It is very useful for reports and tables. 
It takes the form of 


PRINT USING string; value or string — | 


This string or value can be either a variable or constant. 
What will happen is that the string or value to the right of the 
semi-colon will be inserted as specified by the field specifiers, 
the preceding string. 


A) “!’’ This specifies that only the first character in the given 
string is to be printed. so 


Example: | 10 A$ = “ASDF” 
20 PRINT USING “1; A$ 


RUN 
A 





B) “#'’ A number sign is used to represent each digit position. 
Digit positions are always filled. |f the number to be printed 
has fewer digits than positions specified, the number will be — 
right justified (perceded by spaces) in the field. 
“ "" A decimal point may be inserted at any position in the © 
field. If the format string specifies that a digit is to precede 
the decimal point, the digit will always be printed (as @ if 
necessary). Numbers are rounded as necessary. 
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Example: | PRINT USING “##.##”; .78 
0.78 | 





C) “+’’ A plus sign at the beginning or end of the format string 
will cause the sign of the number (plus or minus) to be 
printed before or after the number. 

“_"" & minus sign at the end of the format field will cause 
negative numbers to be printed with a trailing minus sign. 


Examples: | PRINT USING “+##.##’, —68.95 
—68.95 
PRINT USING “##.##-—“, —68.95 
68.95— | 





D) ““**” A double asterisk at the beginning of the format string 
causes leading spaces in the numeric field to be filled with 
asterisks. The ** also specifies positions for two more digits. 


Example: | PRINT USING “**#.#: 0.9 


*9.9 





E) “$$” A double dollar sign causes a dollar sign to be printed 
to the immediate left of the formatted number. The $$ 
specifies two more digit positions, one of which is the 
dollar sign. The exponential format cannot be used with 
$$. Negative numbers cannot be used unless the minus sign 
trails to the right. 









PRINT USING “$$###. ##°, 456.78 


Example: 
; $456.78 
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“**S" The **$ at the beginning of a format string combines 
the effects of the above two symbols. Leading spaces will be 
asterisk-filled and a dollar sign will be printed before the 
number. **$ specifies three more digit positions, one of 
which is the dollar sign. 


“ " A comma that is to the left of the decimal point in a 
formatting string causes a comma to be printed to the left 
of every third digit to the left of the decimal point. A 
comma that is at the end of the format string is printed as . 
part of the string. A comma specifies another digit position. 


Example: | PRINT USING “####,. ia 1234.5 


1,234.50 





G) “%" If the number to be printed is larger than the specified 


numeric field, a percent sign is printed in front of the 
number. If rounding causes the number to exceed the field, 
a percent sign will be printed in front of the rounded 
number. ; 


Examples: | PRINT USING “##. a 111.22 


111.22 


PRINT USING “. ##”; .999 
% 1.00 
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INP (1) 


This returns the byte read from port |. | must be in the range @ 
to 255. INP is the complementary function to the OUT state- 
ment (see below). | 


‘Example: | 700 A =/NP (255) | 


- OUTI,J 


This sends a byte to a machine output port. | and J are integer 
expressions in the range @ to 255. | is the port number and J is 
the data to be transmitted. 


Example: | 100 OUT 32,100 ae 


USR (X) 


This calls the user’s assembly language subroutine with the 
argument X. This subroutine could be taken from tape or made 
by POKEing instruction into memory locations. It is advised 
to take great care when using this function as it can have disas- 
trous effects on any stored program. 


Example: | 770 A =USR (B/2) | 
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CHAPTER 
SOUND AND SONGS 


— SOUND 
— SONGS 
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SOUND 


Another interesting feature of the computer is its ability to 
produce sound, Here is an example program. 


Example: | 70 FOR/=17TO8 
20 READ X 
30 SOUND X, 7 


49 NEXT 
50 DATA 16, 18, 20, 21, 23, 25, 27, 28 
RUN 





This will produce 8 notes going up the scale. In this program 
the variable X is the frequency and the constant 7 is the dura- 
tion of the note. . 

It is possible to get 31 different frequencies and 9 different 
note durations. The tables below show how which codes pro- 
duce the different frequencies and duration. 

By varying the notes and duration therefore, and using the 
tables below, it is possible to produce tunes of your choice. 
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DURATION | 
Code Note Note length 
1 F Z 
8 
1 
2 — ms 
3 
3 J . 
1 
4 a o 
3 
5 4 | 
6 i 1 
1 
7 Pa 1 > 
8 a 2 
9 ol. 3 
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FREQUENCY 

Code Pitch Code Pitch 
0 rest 16 C4 
1 A2 17 C#4 
2 A#2 18 D4 
3 B2 19 D#4 
4 C3 20 E4 
5 C#3 21 F4 
6 D3 22 F#4 
7 D#3 | 23 — G4 
8 E3 24 G#4 
9 F | 25 — AG 
10 F#3 26 A#4 
11 G3 27 B4 
12 G#3 28 C5 
13 A3 29 C#5 

14 A#3 30 D5 
15 


B3 | 31 D#5 
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SONGS 


Below you can see how a musical score is transposed into 
Data for the computer. 


TWINKLE, TWINKLE, LITTLE STAR 
Nursery Rhyme 





TWINKLE, TWINKLE, LITTLE STAR 


2 DATA 21,4, 21,4, 28,4, 28,4, 30,4, 30,4, 28,6, 26,4,26,4,25,4 
4 DATA 25,4, 23,4, 23,4, 21,6, 28,4, 28,4, 26,4, 26,4,25,4,25,4, 
| 23,6 | 
6 DATA 28,4, 28,4, 26,4, 26,4, 25,4, 25,4,23,6,21,4, 21,4, 28,4, 
28,4 
8 DATA 30,4, 30,4, 28,6,26,4,26,4,25,4,25,4,23,4,23,4; 21,6 
10 FOR! =1TO 42: READ F,D: SOUND F,D: NEXT: END 
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COLOR 


— COLOR 
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COLOR 


Your computer, as you already know, is capable of producing 
different colors. With COLOR I, J, | is the foreground color — 
from 1 to 8 and J is the background color — from @ to 1. 


In MODE (9): 

Code Color 

1 Green 

2 Yellow 
3 Blue 

4 Red 

5 Buff 

6 Cyan 

7 Magenta 
8 Orange 


The background color can be either green (@) or orange (1). 
To change the background color just type color, 1. To get back 
to the original just repeat using @ instead of 1. 


In MODE (1) 

With background color is green (Q) 
Color Code Color 

1 green 

2 yellow 

3 blue 

4 red 

and with background color buff (1). 
Color code Color 

5 buff 

6 cyan 

7 magenta 

8 orange 
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Your computer will also accept COLOR |! or COLOR J. It 
will remain in the defined color mode until another COLOR 
command is executed. 


10 FOR!=9TO15 
20 FORJ=9T031 
30 COLOR (1/2) +1 


49 PRINT “@”; 

50 NEXT : NEXT 

69 FOR!=1T0O 1900: NEXT — 
70 END 





Note: By pressing SHIFT SHIFT] and{J|keys together you get the 
character x. 


This will display the eight colors that your computer is 


capable of production in this mode. 
The colors in your computer are very suitable for graphic 
and game purposes especially in MODE (1). 
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THE PRINTER 


— LLST 
— L PRINT 
— COPY 
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To further expand the capabilities of your computer you can 
acquire a PRINTER. This can be attached to your computer 
by means of aPRINTER INTERFACE. If you decide to acquire 
a PRINTER, you will receive a separate leaflet containing 
detailed operating instructions. 


SETTING UP THE PRINTER 





COLOR 
COMPUTER 


To operate the computer successfully you need to be familiar 
with the following: LLIST, LPRINT, COPY. 


LLIST 


This performs a similar function in relation to the PRINTER 
as LIST does in relation to the TV screen. LLIST outputs to 
the PRINTER. 
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LPRINT 


This command (and statement) is similar to PRINT. LPRINT 
is used with the PRINTER. 


COPY 
The PRINTER will print out what you see on the screen to 
the PRINTER. You can stop the PRINTER by pressing the 


[CTRL] [BREAK] key. 


This command can only be used for SEIKOSHA GP-100 
and SEIKOSHA GP-100A PRINTERS. 


142 





APPENDIX 


— ERROR MESSAGE 
— ASCII CODE TABLE 
— SUMMARY OF BASIC COMMANDS 
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ERROR MESSAGE 


— NEXT WITHOUT FOR 

— SYNTAX ERROR 

— RETURN WITHOUT GOSUB 
— OUT OF DATA 

— FUNCTION CODE 

— OVERFLOW 

— QUT OF MEMORY 

— UNDEFINED STATEMENT 

— BAD SUBSCRIPT 

— REDIMENSIONED ARRAY 

— DIVISION BY ZERO 

— ILLEGAL DIRECT 

— TYPE MISMATCH 

— OUT OF SPACE 

— STRING TOO LONG 

— FORMULA TOO COMPLEX 
— CAN’T CONTINUE 

— MISSING OPERAND 

— BAD FILE DATA 

— DISK COMMAND 
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ASCII CODE TABLE i 

ASCII ASCII 

CODE CHARACTER CODE CHARACTER 
32 (Space) 64 @ (at sign) 
33 ! (exclamation point) 65 A 
34 ‘““ (quote) 66 B 
35 # (number or pound sign) 67 C 
36 $ (dollar) 68 D 
37 % (percent) 69 E 
38  & (ampersand) 70 =F 
39 " (apostrophe) 71 G 
4@  ( (open parenthesis) 72 H 
41 ) (close parenthesis) 73 | 

* 42 * (asterisk) 74 J 
43 + (plus) | 75 K 
44 , (comma) 76 L 
45 — (minus) 77 M 
46 - (period) 78 N 
47 / (slant) . 79 O 
48 @ 80 =~ 
49 1 81 OQ 
50 2 82 R 
51 = 3 83 S 
52 4 84 T 
53 5 85 U 
54 6 86 V 
55 7 87 W 
56 8 88 xX 
57 9 89 Y 
58 : (colon) 90 Z 
59 > (semicolon) 
60 < (less than) 
61 = (equals) 





62 > (greater than) 
63 2? (question mark) 
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SUMMARY OF BASIC COMMANDS 


Functions: 


1) 


2) 


3) 


4) 


Arithmetic operators 
a a, me i t 


Relational operators 
2 = = =e 


Arithmetic functions: 


SOR — Square root 

INT — Integer part 

RND — Random number 
ABS — Absolute magnitude 


SGN — Sign 
COS — Cosine 
SIN — Sine 
EXP — e* 


TAN — Tangent 
LOG — Natural logarithm 
ATN — Arc tangent 


String functions: 


LEN — Length 

ST R$ — String of numeric argument 
VAL — Numeric value of string 

ASC — ASCII value 

CHR$ — Character 

LEFT$ — Left characters 

MID$ — Middle characters 

RIGHT$ — Right characters 
INKEY$ — Check keyboard 
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5) Logical operators 
AND : ; 
O Relation and logical expressions have value 1 if true, 
NOT ® if false. 


6) 


7) 


Graphics and sound functions: 


CLS — Clear screen 

SET — Plot a point 

RESET — Clear a point 

POINT — Return the color code 

COLOR — Set color 

SOUND — Produce tone of different frequency and duration 
MODE — Select graphic or text 


Program statements 


DIM — Dimensions 
STOP 

END 

GOTO 

GOSUB 

RETURN 
FOR...TO...STEP 
NEXT 

REM , 
IF... THEN...ELSE 
INPUT 

PRINT 

PRINT TAB 

PRINT USING 
PRINT @ 

LET 

DATA 

READ 

RESTORE 
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8) Commands: 


9) 


LIST 

RUN 

NEW 

CONT 

VERIFY — Check whether program on tape and memory 
are equal 

CLOAD — Load program on tape 

CSAVE — Save program on tape 

CRUN — Load program on tape and run 

CTRL BREAK — To halt program 


Other Statements 


PEEK — Return the value stored at the location specified 
POKE — Load a value into a specified location 

LPRINT — Print on line printer 

LLIST — List on line printer 

INP — Return the contents read from ports 

OUT — Send values to ports 

COPY — Copy the content on screen to printer 

USR — Call the user’s assembly language subroutine 
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